home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / Libraries / Graphic Elements 2 / LibHeaders / GraphElements.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-06-26  |  5.1 KB  |  146 lines  |  [TEXT/MPS ]
  1. /*
  2.     GraphElements.h
  3.     
  4.     Basic Graphic Elements for version 1.5b1
  5.     
  6.     Copyright 1993 by Al Evans. All rights reserved.
  7.     
  8.     6/26/94
  9. */
  10.  
  11. #ifndef GRAPHELEMENTS
  12. #define GRAPHELEMENTS
  13.  
  14. #include "DispCtrl.h"
  15. #include "FastBitCopies.h"
  16.  
  17. #ifdef __cplusplus
  18. extern "C" {
  19. #endif
  20.  
  21. //-------------------------------------------------------------------------------------
  22. //Simple PICT-based Graphic Element
  23. //-------------------------------------------------------------------------------------
  24.  
  25. GrafElPtr NewBasicPICT(GEWorldPtr world, OSType id, short plane, short resNum,
  26.                             short mode, short xPos, short yPos);
  27.                             
  28. //Render proc for basic PICT graphic
  29. pascal void PICTRenderProc(GrafElPtr element, GWorldPtr destGWorld);
  30.  
  31. //-------------------------------------------------------------------------------------
  32. //Scrolling Graphic Element
  33. //-------------------------------------------------------------------------------------
  34.  
  35. typedef struct {
  36.     GrafElement        baseGraphic;
  37.     short            hScroll;            //horiz scroll for each changeIntrvl
  38.     short            vScroll;            //vert scroll for each changeIntrvl    
  39.     short            totalHScroll;        //total current horizontal scroll
  40.     short            totalVScroll;        //total current vertical scroll
  41. } ScrollingGraphic, *ScrlGraphicPtr;
  42.  
  43. //Creation of PICT-based scrolling graphics
  44. GrafElPtr NewScrollingGraphic(GEWorldPtr world, OSType id, short plane, 
  45.                         short resNum, short mode, short xPos, short yPos);
  46.  
  47. //Start or stop (autoHScroll == autoVScroll == 0) auto-scrolling
  48. void AutoScrollGraphic(GEWorldPtr world, OSType elementID, 
  49.                     short interval, short autoHScroll, short autoVScroll);
  50.                     
  51. //Manually set current scroll position
  52. void SetScroll(GEWorldPtr world, OSType elementID, short hScroll, short vScroll);
  53.  
  54. //RenderProc for scrolling graphics
  55. pascal void RenderScrollingGraphic(GrafElPtr graphic, GWorldPtr destGWorld);
  56.  
  57. //AutoChangeProc for scrolling graphics
  58. pascal void ScrollGraphic(GEWorldPtr world, GrafElPtr graphic);
  59.  
  60. //-------------------------------------------------------------------------------------
  61. //Animated (frame-sequence) Graphic Element
  62. //-------------------------------------------------------------------------------------
  63.  
  64. typedef enum {singleframe=0, reciprocating, loop, oneshot} AnimSequence;
  65.  
  66. typedef struct {
  67.     GrafElement    baseGraphic;
  68.     short            currentFrame;        // number of frame now displayed
  69.     short            nFrames;            // number of frames available
  70.     AnimSequence    seq;                // type of animation
  71. } FrameSeqGraphic, *SeqGraphicPtr;
  72.  
  73.  
  74. //Creation of PICT-based multiframe graphics
  75. GrafElPtr NewAnimatedGraphic(GEWorldPtr world, OSType id, short plane, 
  76.                     short resNum, short mode, short xPos, short yPos, short nFrames);
  77.                     
  78. //Activate or deactivate (interval == 0) automatic animation 
  79. void AnimateGraphic(GEWorldPtr world, OSType elementID, 
  80.                     short interval, AnimSequence sequence);
  81.  
  82. //Manually set current frame                    
  83. void SetFrame(GEWorldPtr world, OSType elementID, short newFrame);
  84.  
  85. //Frame sequence forwards or backwards
  86. void SetAnimDirection(GEWorldPtr world, OSType elementID, Boolean forward);
  87.  
  88. //Increment or decrement current frame according to frame sequence
  89. void BumpFrame(GEWorldPtr world, OSType elementID);
  90.  
  91. //Alternate interface to BumpFrame: avoid lookup when GrafElPtr available.
  92. //Also used as AutoChangeProc for frame-based graphics
  93. pascal void PtrBumpFrame(GEWorldPtr world, GrafElPtr graphic);
  94.  
  95. //Set horizontal or vertical mirroring
  96. //NOTE!! Only works for transparent FrameSeqGraphics using default BitCopyProc
  97. //and srcCopy FrameSeqGraphics which have been masked with MakeMask() (see FastBitCopies.h)
  98.  
  99. void SetMirroring(GEWorldPtr world, OSType elementID, Boolean mirrorH, Boolean mirrorV);
  100.  
  101. //RenderProc for frame-changing graphics
  102. pascal void RenderFrameGraphic(GrafElPtr graphic, GWorldPtr destGWorld);
  103.  
  104.  
  105. //-------------------------------------------------------------------------------------
  106. //Simple one-line text graphic
  107. //-------------------------------------------------------------------------------------
  108.  
  109. typedef struct {
  110.     GrafElement        baseGraphic;
  111.     StringPtr        tgText;                //pointer to text
  112.     FontInfo        tgFInfo;            //FontInfo rec for text
  113.     short            tgFontNum;            //etc.
  114.     short            tgFontSize;
  115.     short            tgFontFace;
  116.     RGBColor        tgColor;            //Color for text
  117. } TextGraphic, *TextGraphicPtr;
  118.  
  119. //Create new text graphic
  120. GrafElPtr NewTextGraphic(GEWorldPtr world, OSType id, short plane,
  121.                     short xPos, short yPos, short mode,
  122.                     short fontNum, short txStyle, short size, 
  123.                     RGBColor color, StringPtr text);
  124.  
  125. //Change text of existing text graphic
  126. void SetTextGraphicText(GEWorldPtr world, OSType elementID, StringPtr newText);
  127.  
  128. //RenderProc for text graphics
  129. pascal void RenderTextGraphic(GrafElPtr graphic, GWorldPtr destGWorld);
  130.  
  131. //-------------------------------------------------------------------------------------
  132. //This Graphic Element tiles a single PICT into its (larger) animationRect
  133. //-------------------------------------------------------------------------------------
  134.  
  135. GrafElPtr NewTiledGraphic(GEWorldPtr world, OSType id, short plane, 
  136.                         short resNum, short mode, Rect destRect);
  137.                         
  138. //RenderProc for tiled graphics
  139. pascal void RenderTiledGraphic(GrafElPtr graphic, GWorldPtr destGWorld);
  140.  
  141. #ifdef __cplusplus
  142. }
  143. #endif
  144.  
  145.  
  146. #endif